cs.carrier.{carrier}.bookings.create

统一提交线上订舱

• 请求路由: cs.carrier.{carrier}.bookings.create
• 交互模型: Request Response
• 访问限制: 无

请求

RSocket.rr({
  "route" : "cs.carrier.{carrier}.bookings.create",
  "args" : {
    "request" : "统一订舱请求 DTO"
  }
});

请求参数

名称	类型	必须	说明
carrier	String	是	船公司代码 (如 MSK / COSCO)
request	Object	否	统一订舱请求 DTO
request.receiptTypeAtOrigin	String	否	【必填】起运地服务类型 (CY: 堆场, SD: 门到门, CFS: 货运站)
request.deliveryTypeAtDestination	String	否	【必填】目的地服务类型 (CY: 堆场, SD: 门到门, CFS: 货运站)
request.cargoMovementTypeAtOrigin	String	否	【必填】起运地货物运输方式 (目前仅支持 FCL)
request.cargoMovementTypeAtDestination	String	否	【必填】目的地货物运输方式 (目前仅支持 FCL)
request.isEquipmentSubstitutionAllowed	Boolean	否	【必填】是否允许承运商用替代集装箱设备规格替换
request.isPartialLoadAllowed	Boolean	否	【必填】是否允许分批装运/分票
request.isExportDeclarationRequired	Boolean	否	【必填】是否需要出口申报/报关
request.serviceContractReference	String	否	【选填】服务合同编号 (约号，合同订舱时必填)
request.contractQuotationReference	String	否	【选填】报价合同编号 (即即期报价号，与 serviceContractReference 互斥)
request.bookingChannelReference	String	否	【选填】订舱渠道编号 (如外部订舱系统 Reference，例如 Inttra reference)
request.carrierCode	String	否	【选填】承运商 SCAC 或 SMDG 代码
request.carrierCodeListProvider	String	否	【选填】承运商代码提供方 (SMDG/NMFTA)
request.carrierExportVoyageNumber	String	否	【选填】出口航次号 (没有提供预计时间时必填)
request.expectedDepartureDate	String	否	【选填】预计离港日期 (格式：yyyy-MM-dd)
request.expectedDepartureFromPlaceOfReceiptDate	String	否	【选填】起运地预计离开日期 (格式：yyyy-MM-dd)
request.expectedArrivalAtPlaceOfDeliveryStartDate	String	否	【选填】目的地预计到达开始日期 (格式：yyyy-MM-dd)
request.expectedArrivalAtPlaceOfDeliveryEndDate	String	否	【选填】目的地预计到达结束日期 (格式：yyyy-MM-dd)
request.vessel	Object	否	【选填】船舶信息
request.vessel.name	String	否	【选填】船名
request.vessel.vesselIMONumber	String	否	【选填】船舶 IMO 编号
request.shipmentLocations	Object[]	否	【必填】运输地点列表 (起运地、POL、POD、交货地)
request.shipmentLocations.[].locationTypeCode	String	否	【必填】地点类型代码 (PRE: 收货地, POL: 起运港, POD: 目的港, PDE: 交货地)
request.shipmentLocations.[].location	Object	否	【必填】地点信息
request.shipmentLocations.[].location.locationName	String	否	【选填】物理地点/口岸显示名称
request.shipmentLocations.[].location.locationType	String	否	【选填】地点类型
request.shipmentLocations.[].location.unLocationCode	String	否	【选填】UN/LOCODE 五字港口代码 (如 CNSHK, CNDLC, AUSYD)
request.shipmentLocations.[].location.facility	Object	否	【选填】码头/堆场等设施信息
request.shipmentLocations.[].location.facility.facilityCode	String	否	【选填】设施编码
request.shipmentLocations.[].location.facility.facilityCodeListProvider	String	否	【选填】设施编码提供方 (如 SMDG)
request.requestedEquipments	Object[]	否	【必填】请求承运商提供的集装箱设备柜型柜量列表
request.requestedEquipments.[].isoEquipmentCode	String	否	【必填】ISO 6346 集装箱设备编码 (如 45G1, 22G1)
request.requestedEquipments.[].units	Number	否	【选填】设备柜数数量
request.requestedEquipments.[].isShipperOwned	Boolean	否	【选填】是否自备箱
request.requestedEquipments.[].isNonOperatingReefer	Boolean	否	【选填】是否非运营冷插箱
request.requestedEquipments.[].tareWeight	Object	否	【选填】设备皮重，与货品总毛重分别声明；计量单位由 tareWeight.unit 指定。
request.requestedEquipments.[].tareWeight.value	Number	否	【必填】重量具体值
request.requestedEquipments.[].tareWeight.unit	String	否	【必填】重量单位 (通常为 KGM 或 LBR)
request.requestedEquipments.[].activeReeferSettings	Object	否	【选填】冷藏箱运行参数 (控制箱温等)
request.requestedEquipments.[].activeReeferSettings.temperatureSetpoint	Object	否	【必填】冷箱温度设定值
request.requestedEquipments.[].activeReeferSettings.temperatureSetpoint.value	Number	否	【必填】温度数值
request.requestedEquipments.[].activeReeferSettings.temperatureSetpoint.unit	String	否	【必填】温度单位 (通常为 CEL 摄氏度)
request.requestedEquipments.[].activeReeferSettings.humidity	Number	否	【选填】湿度设定百分比
request.requestedEquipments.[].activeReeferSettings.ventilation	Number	否	【选填】通风量设定
request.requestedEquipments.[].activeReeferSettings.controlledAtmosphere	Boolean	否	【选填】是否受控气调
request.requestedEquipments.[].commodities	Object[]	否	【选填】此柜装运的商品明细信息列表
request.requestedEquipments.[].commodities.[].commodityType	String	否	【必填】品名描述
request.requestedEquipments.[].commodities.[].hsCodes	String[]	否	【选填】HS 商品海关编码列表
request.requestedEquipments.[].commodities.[].cargoGrossWeight	Object	否	【选填】当前商品项全部包装的总毛重，已包含包装数量，不得再次乘件数；单位由 cargoGrossWeight.unit 指定。
request.requestedEquipments.[].commodities.[].cargoGrossWeight.value	Number	否	【必填】重量具体值
request.requestedEquipments.[].commodities.[].cargoGrossWeight.unit	String	否	【必填】重量单位 (通常为 KGM 或 LBR)
request.requestedEquipments.[].commodities.[].outerPackaging	Object	否	【选填】外包装信息
request.requestedEquipments.[].commodities.[].outerPackaging.description	String	否	【选填】包装描述
request.requestedEquipments.[].commodities.[].outerPackaging.quantity	Number	否	【选填】包装件数数量
request.requestedEquipments.[].commodities.[].outerPackaging.typeCode	String	否	【选填】包装类型代码
request.requestedEquipments.[].commodities.[].dangerousGoods	Object[]	否	【选填】危险品明细列表
request.requestedEquipments.[].commodities.[].dangerousGoods.[].unNumber	String	否	【必填】UN 联合国危险品编码
request.requestedEquipments.[].commodities.[].dangerousGoods.[].imoClass	String	否	【必填】IMO 危险货物分类等级
request.requestedEquipments.[].commodities.[].dangerousGoods.[].properShippingName	String	否	【必填】联合国规范运输品名
request.requestedEquipments.[].commodities.[].dangerousGoods.[].technicalName	String	否	【选填】技术名称描述
request.requestedEquipments.[].commodities.[].dangerousGoods.[].packingGroup	String	否	【选填】包装类别 (I, II, III)
request.requestedEquipments.[].commodities.[].dangerousGoods.[].marinePollutant	Boolean	否	【选填】是否海洋污染物
request.requestedEquipments.[].commodities.[].dangerousGoods.[].emergencyContact	Object	否	【选填】紧急联系人信息
request.requestedEquipments.[].commodities.[].dangerousGoods.[].emergencyContact.name	String	否	【必填】紧急联系人姓名
request.requestedEquipments.[].commodities.[].dangerousGoods.[].emergencyContact.phone	String	否	【必填】紧急联系电话
request.documentParties	Object	否	【必填】运输参与方 (联系人、客户号等)
request.documentParties.bookingAgent	Object	否	【必填】订舱代理方 (下单人主体信息)
request.documentParties.bookingAgent.partyName	String	否	【必填】主体企业显示名称
request.documentParties.bookingAgent.unLocationCode	String	否	【选填】所在地 UN/LOCODE 口岸五字代码 (如 HKHKG，Booking Office 必填)
request.documentParties.bookingAgent.partyContactDetails	Object[]	否	【选填】关联的详细联系人列表
request.documentParties.bookingAgent.partyContactDetails.[].name	String	否	【选填】姓名
request.documentParties.bookingAgent.partyContactDetails.[].phone	String	否	【选填】联系电话
request.documentParties.bookingAgent.partyContactDetails.[].email	String	否	【选填】联系邮箱
request.documentParties.bookingAgent.identifyingCodes	Object[]	否	【选填】客户代码列表 (包含马士基 Customer Code 等身份编号)
request.documentParties.bookingAgent.identifyingCodes.[].codeListProvider	String	否	【选填】代码清单提供方
request.documentParties.bookingAgent.identifyingCodes.[].partyCode	String	否	【选填】客户识别代码值 (如 DK00007951)
request.documentParties.bookingAgent.identifyingCodes.[].codeListName	String	否	【选填】编码列表名称描述
request.documentParties.serviceContractOwner	Object	否	【必填】服务合同所有方 (一般同 bookingAgent)
request.documentParties.serviceContractOwner.partyName	String	否	【必填】主体企业显示名称
request.documentParties.serviceContractOwner.unLocationCode	String	否	【选填】所在地 UN/LOCODE 口岸五字代码 (如 HKHKG，Booking Office 必填)
request.documentParties.serviceContractOwner.partyContactDetails	Object[]	否	【选填】关联的详细联系人列表
request.documentParties.serviceContractOwner.partyContactDetails.[].name	String	否	【选填】姓名
request.documentParties.serviceContractOwner.partyContactDetails.[].phone	String	否	【选填】联系电话
request.documentParties.serviceContractOwner.partyContactDetails.[].email	String	否	【选填】联系邮箱
request.documentParties.serviceContractOwner.identifyingCodes	Object[]	否	【选填】客户代码列表 (包含马士基 Customer Code 等身份编号)
request.documentParties.serviceContractOwner.identifyingCodes.[].codeListProvider	String	否	【选填】代码清单提供方
request.documentParties.serviceContractOwner.identifyingCodes.[].partyCode	String	否	【选填】客户识别代码值 (如 DK00007951)
request.documentParties.serviceContractOwner.identifyingCodes.[].codeListName	String	否	【选填】编码列表名称描述
request.documentParties.carrierBookingOffice	Object	否	【必填】承运商订舱受理办公室 (受理口岸)
request.documentParties.carrierBookingOffice.partyName	String	否	【必填】主体企业显示名称
request.documentParties.carrierBookingOffice.unLocationCode	String	否	【选填】所在地 UN/LOCODE 口岸五字代码 (如 HKHKG，Booking Office 必填)
request.documentParties.carrierBookingOffice.partyContactDetails	Object[]	否	【选填】关联的详细联系人列表
request.documentParties.carrierBookingOffice.partyContactDetails.[].name	String	否	【选填】姓名
request.documentParties.carrierBookingOffice.partyContactDetails.[].phone	String	否	【选填】联系电话
request.documentParties.carrierBookingOffice.partyContactDetails.[].email	String	否	【选填】联系邮箱
request.documentParties.carrierBookingOffice.identifyingCodes	Object[]	否	【选填】客户代码列表 (包含马士基 Customer Code 等身份编号)
request.documentParties.carrierBookingOffice.identifyingCodes.[].codeListProvider	String	否	【选填】代码清单提供方
request.documentParties.carrierBookingOffice.identifyingCodes.[].partyCode	String	否	【选填】客户识别代码值 (如 DK00007951)
request.documentParties.carrierBookingOffice.identifyingCodes.[].codeListName	String	否	【选填】编码列表名称描述
request.documentParties.shipper	Object	否	【选填】实际发货人
request.documentParties.shipper.partyName	String	否	【必填】主体企业显示名称
request.documentParties.shipper.unLocationCode	String	否	【选填】所在地 UN/LOCODE 口岸五字代码 (如 HKHKG，Booking Office 必填)
request.documentParties.shipper.partyContactDetails	Object[]	否	【选填】关联的详细联系人列表
request.documentParties.shipper.partyContactDetails.[].name	String	否	【选填】姓名
request.documentParties.shipper.partyContactDetails.[].phone	String	否	【选填】联系电话
request.documentParties.shipper.partyContactDetails.[].email	String	否	【选填】联系邮箱
request.documentParties.shipper.identifyingCodes	Object[]	否	【选填】客户代码列表 (包含马士基 Customer Code 等身份编号)
request.documentParties.shipper.identifyingCodes.[].codeListProvider	String	否	【选填】代码清单提供方
request.documentParties.shipper.identifyingCodes.[].partyCode	String	否	【选填】客户识别代码值 (如 DK00007951)
request.documentParties.shipper.identifyingCodes.[].codeListName	String	否	【选填】编码列表名称描述
request.documentParties.consignee	Object	否	【选填】实际收货人
request.documentParties.consignee.partyName	String	否	【必填】主体企业显示名称
request.documentParties.consignee.unLocationCode	String	否	【选填】所在地 UN/LOCODE 口岸五字代码 (如 HKHKG，Booking Office 必填)
request.documentParties.consignee.partyContactDetails	Object[]	否	【选填】关联的详细联系人列表
request.documentParties.consignee.partyContactDetails.[].name	String	否	【选填】姓名
request.documentParties.consignee.partyContactDetails.[].phone	String	否	【选填】联系电话
request.documentParties.consignee.partyContactDetails.[].email	String	否	【选填】联系邮箱
request.documentParties.consignee.identifyingCodes	Object[]	否	【选填】客户代码列表 (包含马士基 Customer Code 等身份编号)
request.documentParties.consignee.identifyingCodes.[].codeListProvider	String	否	【选填】代码清单提供方
request.documentParties.consignee.identifyingCodes.[].partyCode	String	否	【选填】客户识别代码值 (如 DK00007951)
request.documentParties.consignee.identifyingCodes.[].codeListName	String	否	【选填】编码列表名称描述
request.paymentTerms	Object	否	【选填】付款条款
request.paymentTerms.freightPaymentTermCode	String	否	【选填】运费付款方式 (PRE: 预付, COL: 到付)
request.paymentTerms.originChargesPaymentTermCode	String	否	【选填】起运港杂费支付方式
request.paymentTerms.destinationChargesPaymentTermCode	String	否	【选填】目的地杂费支付方式
request.incoTerms	Object	否	【选填】国际贸易术语
request.incoTerms.code	String	否	【必填】国际贸易术语代码 (如 FOB, CIF, EXW)
request.incoTerms.location	String	否	【选填】贸易术语地点
request.carrierProprietaryAttributes	Object[]	否	【选填】承运商专用扩展属性
request.carrierProprietaryAttributes.[].attributeName	String	否	【必填】扩展属性名键名
request.carrierProprietaryAttributes.[].attributeValue	String	否	【必填】扩展属性键值

返回

船公司订舱响应

{ }

返回属性

名称	类型	说明
carrierBookingRequestReference	String	订舱申请唯一参考号 (UUID)
carrierBookingReference	String	承运商最终订舱参考号 (SO号)
preliminaryCarrierBookingReference	String	承运商初步订舱参考号 (如马士基返回的 KA0642495)
bookingStatus	String	订舱状态 (RECEIVED, CONFIRMED, DECLINED, CANCELLED 等)
comment	String	说明或失败原因备注

下载结果模型定义